跳到主要内容

获取持仓信息

请求类型 GET

接口地址: /future/user/v1/position

请求参数​

参数名类型是否必填默认值描述
symbolstring否N/A交易对（不传时查询所有交易对的持仓信息）

限流规则​

200次/秒/apikey

请求示例​

Request
curl -G "https://fapi.xt.com/future/user/v1/position" \ 
  -H "validate-appkey: $APPKEY" \  # 必须
  -H "validate-timestamp: $TIMESTAMP" \  # 必须
  -H "validate-singature: $SINGATURE" \  # 必须
  -H "Content-Type: application/x-www-form-urlencoded" \  # 必须
  -d "symbol=eth_usdt"

响应示例​

Response
{
  "error": {
    "args": [],
    "code": "",
    "msg": ""
  },
  "msgInfo": "",
  "result": [
    {
      "autoMargin": false, // 是否自动追加保证金
      "availableCloseSize": 0, // 可平仓数量（张）
      "breakPrice": 0, // 强平价格
      "calMarkPrice": 0, // 计算标记价格
      "closeOrderSize": 0, // 已挂单数量（张）
      "contractType": "", // 合约类型：PERPETUAL（永续合约）、PREDICT（预测合约）
      "entryPrice": 0, // 开仓均价
      "floatingPL": 0, // 未实现盈亏
      "isolatedMargin": 0, // 仓位保证金（逐仓）
      "leverage": 0, // 杠杆倍数
      "openOrderMarginFrozen": 0, // 开仓委托冻结保证金
      "openOrderSize": 0, // 开仓委托占用数量
      "positionSide": "", // 仓位方向
      "positionSize": 0, // 仓位数量（张）
      "positionType": "", // 仓位类型：CROSSED（全仓）；ISOLATED（逐仓）
      "profitId": 0, // 止盈止损ID
      "realizedProfit": 0, // 已实现盈亏
      "symbol": "", // 交易对
      "triggerPriceType": "", // 触发价格类型：1. 指数价格；2. 标记价格（合理价格）；3. 最新价格
      "triggerProfitPrice": 0, // 止盈触发价
      "triggerStopPrice": 0, // 止损触发价
      "welfareAccount": true // 是否为福利账户
    }
  ],
  "returnCode": 0
}

错误码​

Error codeDesc